Spaces'te URL parametrelerini nasıl işlenir

URL sorgu parametrelerini bir veri paylaşım mekanizması olarak kullanabilirsiniz; örneğin, belirli bir durumla bir uygulamaya derin bağlantı kurmak için.

Bir Space sayfasında (https://huggingface.co/spaces/<user>/<app>), gerçek uygulama sayfası (https://*.hf.space/) bir iframe içinde gömülüdür. Ana sayfa URL'sine eklenen sorgu dizesi ve hash, ilk yüklemede gömülü uygulamaya aktarılır; böylece gömülü uygulama bu değerleri özel bir işlem gerektirmeden okuyabilir.

Buna karşılık, gömülü uygulamadan ana sayfa URL'sinin sorgu dizesini ve hash değerini güncellemek biraz daha karmaşıktır. Bunu bir Docker veya statik Space'te yapmak istiyorsanız, queryString ve/veya hash anahtarına sahip bir mesajı ana sayfaya gönderen aşağıdaki JS kodunu eklemeniz gerekir.

const queryString = "...";
const hash = "...";

window.parent.postMessage({
    queryString,
    hash,
}, "https://huggingface.co");

Bu yalnızca Docker veya statik Spaces içindir.

Streamlit uygulamaları için Spaces, URL parametrelerini otomatik olarak senkronize eder. Gradio uygulamaları, Spaces sayfasından sorgu parametrelerini okuyabilir ancak güncellenen URL parametrelerini üst sayfa ile senkronize etmez.

Ana sayfanın URL parametrelerinin gömülü uygulamaya sadece ilk yüklemede aktarıldığını unutmayın. Bu nedenle, ana URL hash'i bu yöntemle güncellense bile gömülü uygulamadaki location.hash değişmez.

Bu yöntemin bir örneği, bu statik Space'te bulunabilir: whitphx/static-url-param-sync-example.