Der Stil einer Umfrage ist eine Liste von Anpassungen: diejenigen, die der Stileditor anbietet (Farbpalette, Schriftarten, Logo und die anderen), plus dein eigenes CSS. Diese Seite richtet sich an Entwickler und Coding-Agenten, die dieses CSS schreiben. Es erscheint in der Vorschau, auf dem öffentlichen Umfragelink und in Umfragen, die auf deiner Website eingebettet sind.
Dein CSS hinzufügen
- Öffne die Umfrage und gehe zu Erstellen → Vorschau.
- Wähle Anpassung hinzufügen, dann Eigenes CSS unter Erweitert und Zur Seite hinzufügen.
- Gib ihm einen Titel und schreibe dein CSS.
- Speichere die Umfrage, um sie zu veröffentlichen, oder wähle Als Arbeitsbereichsstil speichern, um den Stil in anderen Umfragen wiederzuverwenden.
Füge Eigenes CSS so oft hinzu, wie du möchtest, zum Beispiel eines für die Fragen und eines für die Navigation.
Wie dein CSS angewendet wird:
- Es ist auf die Umfrage beschränkt: Jeder Selektor wird in
.survey-themeplatziert.:root,htmlundbodybedeuten.survey-themeselbst, und.darkvor einem Selektor bedeutet Dunkelmodus. - Anpassungen gelten in der Reihenfolge, in der sie hinzugefügt wurden. Eine spätere hat Vorrang vor einer früheren, unabhängig von der Spezifität ihrer Selektoren, sodass Eigenes CSS Vorrang vor den davor hinzugefügten Anpassungen hat.
- Eine ausgeschaltete Anpassung fügt nichts hinzu.
Die Seite
Schreibe dein CSS für die Klassennamen und Attribute auf dieser Seite. Sie bleiben zwischen den Versionen stabil. Andere Klassennamen auf der Seite sind intern und können ohne Vorankündigung geändert werden.
Struktur
Jede Umfrageseite ist, unabhängig vom Stil, aus denselben Teilen in derselben Reihenfolge aufgebaut:
.survey-theme- die Wurzel, wo die Variablen gesetzt werden.survey-image-layer- ein eigenes Bild hinter der Seite, wie der Seitenhintergrund.survey-shell- die Seite.survey-language- die Sprachauswahl, wenn die Umfrage mehr als eine Sprache hat.survey-media- der Bildbereich, nur beicover,splitundoverlap.survey-image- eines für jedes Bild, der Reihe nach.survey-logo- das Logo, wenn es sich im Bildbereich befindet
.survey-surface- die Umfrage selbst, als eine Box. Beicardundoverlapist es die Karte.survey-progress- der Fortschrittsbalken, wenn er oben ist.survey-header- die Leiste oben.survey-logo- das Logo, wenn es in der Kopfzeile ist.survey-progress- der Fortschrittsbalken, wenn er in der Kopfzeile ist.survey-page-count- „Schritt 2 von 5“, wenn es in der Kopfzeile ist
.survey-main.survey-content- die Inhaltsspalte.survey-questions- die Fragen der Seite.question- eine Frage (siehe Fragen), und.survey-text- ein Textblock
.survey-footer- die Leiste unten.survey-progress- der Fortschrittsbalken, wenn er über den Buttons ist.survey-page-count- „Schritt 2 von 5“.survey-navigation- die Buttons.survey-navigation-buttons- eine Zeile:.survey-navigation-back,.survey-navigation-next,.survey-navigation-submit
.survey-portals- wohin Popups kommen: die Datumsauswahl, Menüs und Dialoge. Dein CSS erreicht sie
.survey-progress enthält den ausgefüllten Teil .survey-progress-bar, und .survey-page-count enthält den Text .survey-navigation-step.
Attribute auf der Wurzel
| Attribut | Werte |
|---|---|
data-layout |
document, card, cover, split oder overlap |
data-surface |
fills bei document, cover und split; floats bei card und overlap |
data-page |
Die ID der Umfrageseite auf dem Bildschirm |
Teile, die ihren Platz wechseln
Das Logo und der Fortschrittsbalken sind jeweils einmal auf der Seite, an einem der Plätze in der Struktur, oder gar nicht. Die Sprachauswahl, der Fortschrittsbalken und der Schrittzähler haben data-at, was angibt, wo sie sich befinden:
| Teil | data-at |
|---|---|
.survey-language |
top (oben auf der Seite, ihr Platz, es sei denn, eine Anpassung verschiebt sie), header oder media (der Bildbereich) |
.survey-progress |
top, header oder nav (über den Buttons) |
.survey-page-count |
header oder nav |
Eine Regel für .survey-progress gestaltet ihn überall, wo er ist, und .survey-progress[data-at="header"] nur in der Kopfzeile.
Abstände
Die Spalten und Zeilen legen ihre Abstände auf dem Container fest:
| Teil | Was den Abstand festlegt |
|---|---|
.survey-questions |
Eine Spalte: gap ist der Abstand zwischen den Fragen, padding-bottom der Platz unter der letzten |
.question |
Eine Spalte: gap ist der Abstand zwischen ihren Teilen |
.question-options |
gap ist der Abstand zwischen den Optionen. Eine Spalte von Optionen ist ein Grid: grid-template-columns legt die Spalten fest |
.survey-navigation-buttons |
Eine Zeile: gap ist der Abstand zwischen den Buttons, justify-content wo sie sitzen. “Weiter” hat margin-inline-start: auto, was ihn am Ende hält |
Bilder
.survey-image-layerhatdata-image, was das Bild benennt, wiedata-image="background--image"für den Seitenhintergrund. Sein::beforeund::afterzeichnen das Bild und seine Effekte..survey-mediahatdata-slot="media".- Jedes
.survey-imagezeichnet sein Bild auf::beforeund hat--index(ab 0),--count(wie viele es gibt) und--ratio(Breite durch Höhe).
Der Bildbereich schneidet ab, was seine Bilder außerhalb von ihm zeichnen, wie einen drop-shadow auf .survey-image, und die Teile danach werden darüber gezeichnet. Für einen Effekt, der über den Bildbereich hinausreicht, wie ein Schatten oder ein Leuchten:
- setze ihn auf
.survey-mediaselbst, oder setzeoverflow: visibledarauf - gib ihm einen
z-index, damit er über das Folgende gezeichnet wird
Bei card und overlap liegt die Box der Umfrage über der unteren Kante des Bildbereichs, sodass ein Schatten dort unter der Box liegt.
Fragen
Jede Frage ist eine .question, die Folgendes enthält:
.question-title- der Fragetext, mit.question-required(dem*) darin.question-description- der Hilfetext.question-answer- die Antwort-Eingabe.question-options- die Liste der Optionen, Skalenpunkte oder Elemente darin
.question-error- die Nachricht, die angezeigt wird, wenn eine Antwort fehlt oder ungültig ist
Füge die Typ-Klasse hinzu, um einen Fragetyp zu gestalten, zum Beispiel .question-type-select-one .question-title: .question-type-string, -number, -date, -boolean, -select-one, -select-many, -ranking, -interval-scale (numerische Bewertungsskalen, wie NPS), -ordinal-scale, -matrix, -open-list und -payment.
Die Antwort-Bedienelemente tragen Attribute:
| Attribut | Auf |
|---|---|
data-survey-control |
Die Bedienelemente, auf die ein Befragter klickt: Auswahl-Buttons, Skalenpunkte, Optionszeilen, Dropdowns |
data-selected |
Ein Bedienelement, solange es die gegebene Antwort ist |
data-survey-input |
Die Felder, in die ein Befragter tippt: Text, Zahlen, Listenelemente |
aria-pressed="true" |
Der ausgewählte Button auf einer numerischen Bewertungsskala |
Variablen, die du auslesen kannst
Lies diese mit var() aus, damit deine Anpassung dem Rest des Stils folgt. Sie werden aktualisiert, wenn Personen die Farbpalette, Schriftarten oder Größen ändern, sowohl im hellen als auch im dunklen Modus.
| Variable | Was sie ist |
|---|---|
--background, --foreground |
Die Seite und ihr Text |
--card, --card-foreground |
Karten und ihr Text |
--popover, --popover-foreground |
Popups und ihr Text |
--primary, --primary-foreground |
Die Hauptfarbe (die gewählte Antwort, die Haupt-Buttons) und der Text darauf |
--secondary, --secondary-foreground |
Sekundäre Buttons und ihr Text |
--muted, --muted-foreground |
Ruhige Bereiche und Hilfetexte |
--accent, --accent-foreground |
Elemente beim Hovern und Hervorheben sowie ihr Text |
--destructive |
Fehler |
--border, --input, --ring |
Rahmen, die Füllung von Antwort-Bedienelementen, der Fokus-Ring |
--radius |
Der Eckenradius, an dem alles gemessen wird |
--spacing |
Die Einheit für Abstände |
--font-sans, --font-serif, --font-mono |
Die Schriftarten |
--content-width |
Die maximale Breite der Inhaltsspalte. Die Navigation hat dieselbe Breite |
--content-pad |
Der Platz innerhalb der Inhaltsspalte und an den Seiten der Navigation |
--rail-pad |
Der Platz innerhalb der Kopfzeile sowie über und unter der Navigation |
Animationen
@keyframes-Namen sind global. Gib deinen ein eigenes Präfix, damit sie nicht mit denen des Stils kollidieren.- Stoppe deine Animationen unter
@media (prefers-reduced-motion: reduce).
Zwischen Seiten wechseln
Der Wechsel zur nächsten oder vorherigen Seite ist eine View Transition. Nichts auf der Seite bewegt sich, es sei denn, dein CSS gibt ihm einen view-transition-name. Ohne einen Namen ändert sich die Seite sofort.
Während sich die Seite bewegt, werden drei Attribute auf <html> gesetzt:
| Attribut | Werte |
|---|---|
data-vt |
forward auf dem Weg zur nächsten Seite, back auf dem Weg zur vorherigen |
data-vt-capture |
old, während der Browser die Seite erfasst, die verlassen wird, new, während er die Seite erfasst, die ankommt |
data-vt-scroll |
scrolled, wenn die Seite, die verlassen wird, nach unten gescrollt war, top, wenn sie ganz oben war. Die Seite, die ankommt, beginnt immer ganz oben |
Gib einem Teil auf jeder Seite einen anderen Namen, -old und -new. Die Seite, die verlassen wird, bewegt sich dann von dort, wo der Befragte sie gesehen hat, und die Seite, die ankommt, bewegt sich dorthin, wo sie landet. Mit einem Namen für beide bewegt der Browser den Teil auch von seinem alten Platz an seinen neuen: Auf einer langen Seite, die nach unten gescrollt ist, gleitet er weit nach unten, während die Seite nach oben geht.
Dies lässt die Umfrage auf dem Weg zur nächsten Seite nach links gleiten:
html[data-vt-capture="old"] .survey-surface {
view-transition-name: my-surface-old;
}
html[data-vt-capture="new"] .survey-surface {
view-transition-name: my-surface-new;
}
html[data-vt="forward"]::view-transition-old(my-surface-old) {
animation: my-slide-out 0.3s ease-in forwards;
}
html[data-vt="forward"]::view-transition-new(my-surface-new) {
animation: my-slide-in 0.3s ease-out forwards;
}
@keyframes my-slide-out {
to {
opacity: 0;
transform: translateX(-30%);
}
}
@keyframes my-slide-in {
from {
opacity: 0;
transform: translateX(30%);
}
}
Ein Teil, der auf beiden Seiten an derselben Stelle sitzt, wie ein Fortschrittsbalken oben, kann einen Namen behalten. Die Namen der Kopf- und Fußzeile sind --header-transition-name und --footer-transition-name auf .survey-theme, none, wenn sie keinen haben.
Beispiele
Jedes Beispiel funktioniert für sich allein als Eigenes CSS. Kombiniere die, die du brauchst.
Fragen
Fragetext in deiner Markenfarbe
.question-title {
color: var(--primary);
}
Größerer Fragetext
.question-title {
font-size: 1.5rem;
}
Größere Buttons bei Bewertungsskalen
Für NPS und andere numerische Bewertungsskalen, die Buttons verwenden:
.question-type-interval-scale button {
height: 3.5rem;
font-size: 1.5rem;
}
Eine Skala, die als Dock angezeigt wird (quadratische Punkte, die unter dem Zeiger wachsen), wird durch eine Variable skaliert, die maximale Breite eines Punktes:
.question-type-interval-scale .question-answer {
--scale-point: 3.5rem;
}
Der gewählte Wert auf einer Bewertungsskala
.question-type-interval-scale button[aria-pressed="true"] {
background: #0b5fff;
color: white;
}
Fortschritt und Navigation
Dickerer Fortschrittsbalken
.survey-progress {
height: 6px;
}
Schrittzähler ausblenden
Entfernt „Schritt 2 von 5“, wo auch immer die Seite ihn anzeigt:
.survey-navigation-step {
display: none;
}
Runde Navigations-Buttons
.survey-navigation-next,
.survey-navigation-submit {
border-radius: 9999px;
}
Schatten über der Navigation
.survey-footer {
box-shadow: 0 -4px 12px #0001;
}
Layout
Schmalere Spalten für Fragen und Navigation
--content-width legt die Breite der Fragen und der Navigation gemeinsam fest:
.survey-theme {
--content-width: 36rem;
}
Sprachauswahl in der linken Ecke
.survey-language {
inset: 0.75rem auto auto 0.75rem;
}
Logo und Sprachauswahl auf einer Linie mit den Fragen
Die Kopfzeile behält die volle Breite der Seite, und das Logo und die Sprachauswahl rücken an die Ränder der Fragenspalte:
.survey-theme {
--gutter: max(0px, (100% - var(--content-width)) / 2);
}
.survey-header {
padding-inline: var(--gutter);
}
.survey-language {
right: max(0.75rem, var(--gutter) + var(--content-pad));
}
Ein Schatten unter dem Bild
Bei cover und split, wo nichts über der unteren Kante des Bildbereichs liegt:
.survey-media[data-slot="media"] {
z-index: 1;
box-shadow: 0 8px 16px rgb(0 0 0 / 0.25);
}
Text und Seiten
Eine Seite sieht anders aus
Dies zentriert den Text nur auf der Seite mit der ID intro:
.survey-theme[data-page="intro"] .survey-content {
text-align: center;
}
Umfrage-Überschriften
Dies färbt jedes h1 und h2 auf der Umfrageseite ein, einschließlich Textblöcken und dem Titel der Abschlussseite:
h1,
h2 {
color: var(--primary);
}
Was nicht erlaubt ist
Um die Befragten zu schützen, kann ein Stil nicht mit CSS gespeichert werden, das:
@import,image-set()odersrc()verwendet, oderurl()ohne einedata:-URL nutzt. Füge Bilder stattdessen im Stileditor hinzu- Schriftarten mit
@font-facehinzufügt. Wähle stattdessen eine Schriftart im Abschnitt Schriftarten - auf
[value],[checked]oder[selected]zugreift, was Antworten preisgeben könnte - ungültiges CSS oder die Zeichenfolge
</enthält - länger als 50.000 Zeichen ist