编程
用于描述按钮、菜单、表单、搜索、键盘操作与反馈状态的可搜索参考。
47 个项目
指针与触控
Click
onClickA pointer action where the user presses and releases a mouse button on an element.
Use click for actions such as opening menus, submitting buttons, selecting items, or navigating with links.
When the menu button is clicked, open the menu panel.
指针与触控
Tap
touch / pointerA touch-screen action where the user touches and releases an element.
Tap should generally do the same important work as click on phones and tablets.
Hover-only behavior is unreliable on touch devices.
Make the category menu open by tap instead of hover on mobile.
指针与触控
Hover
:hoverThe state when a mouse pointer is over an element.
Hover can preview affordance with color, underline, background, or shadow changes.
Do not make essential actions depend only on hover.
Change the menu item background when it is hovered.
指针与触控
Long press
touch holdA touch action where the user holds a finger on an element for a longer moment.
Long press is often used for secondary actions, but it is less discoverable than a visible button.
Avoid long press as the only way to access important functionality.
Do not hide essential copy actions behind long press only.
指针与触控
Drag
pointerdown + pointermoveA pointer action where the user holds and moves an element or selection.
Drag interactions need clear handles, boundaries, and fallback controls when precision matters.
Add a visible handle if a panel can be dragged.
指针与触控
Swipe
touch moveA touch gesture where the user moves a finger quickly across the screen.
Swipe can move carousels or panels, but visible controls should still exist.
Allow swipe between examples, but keep arrow buttons visible.
键盘
Keyboard event
keydown / keyupAn interaction caused by pressing or releasing a keyboard key.
Keyboard events are used for Escape-to-close, Enter-to-submit, arrow navigation, and shortcuts.
Close the dropdown when the Escape key is pressed.
键盘
Escape key
EscapeA keyboard key commonly used to cancel, close, or exit a temporary UI.
Dropdowns, menus, modals, and popovers should usually close on Escape.
Make both the language dropdown and site menu close on Escape.
键盘
Enter key
EnterA keyboard key often used to activate a focused control or submit a form.
A focused button should activate with Enter. Search forms may submit with Enter.
Let Enter run the search when the search field is focused.
键盘
Tab key
TabA keyboard key used to move focus through interactive controls.
The Tab order should follow the visible reading and interaction order.
Keep the tab order natural across the header controls.
UI 状态
Focus
:focus / :focus-visibleThe state where an element is ready for keyboard input or activation.
Focused controls should have a visible outline or focus style.
Make the focused search input clearly visible.
UI 状态
Blur
blur / focusoutThe state change when an element loses focus.
Blur can validate input or close lightweight UI, but it should not surprise users.
Do not clear the search text when the input loses focus.
UI 状态
Active state
:activeA short state while a control is being pressed.
Active state can show a pressed effect with a slight background, border, or position change.
Add a subtle pressed state to icon buttons.
UI 状态
Selected state
selected / aria-currentThe state of an item that is currently chosen in a list, menu, tab group, or filter group.
Selected items should be visually different from unselected items.
Make the active category chip clearly different from inactive chips.
UI 状态
Disabled state
disabled / aria-disabledA state where a control is visible but cannot be used.
Disabled controls should look inactive but remain understandable.
Disable the submit button until required input is valid.
UI 状态
Checked state
checkedThe on or selected state of a checkbox, radio, or switch-like control.
Checked state should be visibly clear and announced by the control semantics.
Show a clear checked state for selected options.
打开与关闭
Toggle
toggle stateAn action that switches between two states, such as open and closed or on and off.
A toggle should show its current state and update that state predictably.
Use one button to toggle each menu category open and closed.
打开与关闭
Open / close
open / closedA visibility state where a panel, menu, or section is shown or hidden.
Open and close states should be controlled consistently by buttons, outside click, Escape, or selection.
Close the site menu when the language dropdown opens.
打开与关闭
Dropdown
button -> panelA floating list that appears from a button or field.
Dropdowns usually close after selection, outside click, or Escape.
When a language is selected, close the dropdown.
打开与关闭
Accordion
section toggleA UI pattern where section headers open or close their content.
Accordions should clearly indicate which sections are open.
Keep all accordion categories closed by default.
打开与关闭
Modal
open dialogA focused overlay that appears above the page and usually blocks the background content.
Modals need close controls, Escape behavior, focus handling, and clear purpose.
Add a close button and Escape-to-close behavior to the modal.
打开与关闭
Outside click
document pointerdownA click or tap outside a temporary panel such as a dropdown, menu, or popover.
Temporary panels commonly close when the user clicks outside them.
Controls that belong to the same header group may not count as outside unless the logic is written that way.
Close the menu when the user clicks outside the menu panel.
打开与关闭
Focus trap
modal openA behavior that keeps keyboard focus inside a modal or dialog while it is open.
Focus trap prevents keyboard users from accidentally moving behind an active modal.
Trap focus inside the modal until it is closed.
导航
Link navigation
link clickMoving to another page, route, or section through a link.
Links should use correct destinations and close temporary menus after navigation.
Close the menu after a menu link is clicked.
导航
Route change
router navigationA change from one application route or URL path to another.
Route changes should update page content, metadata, and active navigation state.
Update the active navigation state after route changes.
导航
Scroll
wheel / touch scrollMoving the visible viewport through content that is larger than the screen.
Scrolling can happen on the page or inside a panel with its own overflow.
Make long dropdown menus scroll inside the panel instead of extending off screen.
导航
Anchor scroll
href=#idA link behavior that scrolls to an element with a matching id on the same page.
Anchor links are useful for jumping to tools, references, or sections.
Make the Browse tools button scroll to the tools section.
输入与表单
Type
input eventEntering text or values into an input or textarea.
Typing can update state immediately, validate input, or wait until submission.
Update search results as the user types.
输入与表单
Submit
submit eventSending or applying form input.
Submit should validate required input, prevent accidental reloads when needed, and show feedback.
Prevent the form from reloading the page when it submits.
输入与表单
Reset
reset actionReturning controls or values to their default state.
Reset should be predictable and avoid erasing important work without warning.
Add a reset button that clears search and returns to all categories.
输入与表单
Validation
input / submitChecking whether user input is complete and valid.
Validation should explain what is wrong and how to fix it.
Show a validation message when the input value is invalid.
搜索与筛选
Search
query changeFinding matching items based on text entered by the user.
Search should check useful fields such as names, aliases, descriptions, and examples.
Make the search match Korean words, English terms, aliases, and request examples.
搜索与筛选
Filter
filter stateNarrowing a list to items that match a selected condition.
Filters should show which condition is active and how many items remain when useful.
Add category filters above the UI interaction term cards.
搜索与筛选
Sort
sort optionChanging the order of items by a rule such as name, date, priority, or category.
Sorting should not remove items; it only changes their order.
Sort matching terms alphabetically after filtering.
搜索与筛选
Debounce
delayed inputWaiting briefly after the user stops typing before running an expensive action.
Debounce prevents search, validation, or API calls from running on every single keystroke.
Debounce the search input if it becomes slow with many items.
搜索与筛选
Clear
clear actionRemoving a typed value, selected filter, or temporary state.
Clear actions should affect only the intended field or state.
Add a clear button inside the search field.
反馈
Loading
pending stateA temporary state while data, page content, or an action is still being prepared.
Loading feedback tells users that the app is working and prevents repeated actions when needed.
Show a loading state while the conversion result is being prepared.
反馈
Spinner
loading visualA visual indicator that something is loading or processing.
Spinners work best for short waits; longer waits may need clearer progress or text.
Show a small spinner inside the button while submitting.
反馈
Toast
temporary messageA short temporary message that appears after an action.
Toasts are useful for confirmations such as copied, saved, or updated.
Show a toast after copying text to the clipboard.
反馈
Error state
errorA state that tells the user something went wrong.
Error messages should be specific, readable, and explain the next useful action.
Show a clear error message when the input cannot be converted.
反馈
Success state
successA state that confirms an action completed successfully.
Success states can be subtle when the result is already visible.
Show a small success message after settings are saved.
反馈
Empty state
empty resultA state shown when there is no data or no matching result.
Empty states should explain why nothing is shown and suggest a next step.
Show a no-results message when search returns no matching terms.
反馈
Copy to clipboard
navigator.clipboardAn action that puts text into the user's clipboard.
Copy actions should give feedback so users know the text was copied.
Copy the CSS property when the property chip is clicked.
动效与时间
Transition
CSS transitionA smooth change between two visual states, such as color, opacity, or position.
Transitions can make UI feel polished, but should stay quick for tools.
Add a short transition to menu item hover colors.
动效与时间
Animation
CSS animationA visual motion sequence that can run once or repeatedly.
Animation should support the task, not distract from reading or repeated work.
Use a subtle slide-down animation when the dropdown opens.
动效与时间
Delay
setTimeout / delayA wait before something happens or disappears.
Delays can make feedback readable, but long delays can make the UI feel slow.
Keep the copied toast visible for about one second.
动效与时间
Throttle
limited repeated eventsLimiting how often a repeated event handler can run.
Throttle is useful for scroll or resize handlers that fire many times.
Throttle the scroll handler if the page becomes janky.