Настройка какого поля позволяет ограничивать список пользователей: Список пользователей

Код Visual Studio легко настроить по своему вкусу с помощью его различных настроек. Почти каждая часть редактора, пользовательского интерфейса и функционального поведения VS Code имеет опции, которые вы можете изменить.

VS Code предоставляет две различные области настройки:

• Пользовательские настройки — настройки, которые применяются глобально к любому экземпляру кода VS, который вы открываете.
• Настройки рабочего пространства — Настройки хранятся в вашем рабочем пространстве и применяются только при открытом рабочем пространстве.

Настройки рабочего пространства переопределяют пользовательские настройки. Параметры рабочего пространства специфичны для проекта и могут быть общими для всех разработчиков проекта.

Примечание : «Рабочая область» кода VS — это обычно просто корневая папка вашего проекта. Параметры рабочего пространства, а также конфигурации отладки и задач хранятся в корневом каталоге в папке .vscode . Вы также можете иметь более одной корневой папки в рабочем пространстве VS Code с помощью функции под названием Multi-root workspace.

Создание настроек пользователя и рабочей области

Чтобы открыть настройки пользователя и рабочего пространства, используйте следующую команду меню VS Code:

• В Windows / Linux — Файл > Настройки > Настройки
• В macOS — Код > Предпочтения > Настройки

Вы также можете открыть редактор настроек из палитры команд (⇧⌘P (Windows, Linux Ctrl + Shift + P)) с настройками : откройте настройки или используйте сочетание клавиш (⌘, (Windows, Linux Ctrl +, )).

В приведенном ниже примере цветовая тема и тема значков файлов были изменены.

Изменения настроек перезагружаются VS Code по мере их изменения. Измененные настройки теперь обозначаются синей линией , аналогичной измененным строкам в редакторе. Значок шестеренки открывает контекстное меню с параметрами для сброса настроек до значений по умолчанию, а также копирования настроек в формате JSON.

Примечание: Параметры рабочего пространства полезны для совместного использования параметров проекта в группе.

Редактор настроек

Когда вы открываете редактор настроек, вы можете искать и находить нужные вам настройки. При поиске с использованием панели поиска она не только отображает и выделяет параметры, соответствующие вашим критериям, но также отфильтровывает те, которые не соответствуют. Это делает поиск настроек быстрым и простым.

Примечание : Расширения кода VS также могут добавлять свои собственные пользовательские настройки, и они будут отображаться в разделе Расширения .

Редактировать настройки

Каждый параметр может быть отредактирован с помощью флажка , входа или раскрывающегося списка . Отредактируйте текст или выберите параметр, который вы хотите изменить на нужные параметры.

Настройки группы

Настройки по умолчанию представлены в группах, так что вы можете легко перемещаться по ним. В верхней части находится группа «Обычно используемые », которая показывает популярные настройки.

Ниже приведена копия настроек по умолчанию, которые поставляются с VS Code.

Файл настроек файла

По умолчанию VS Code показывает редактор настроек, но вы все равно можете отредактировать базовый файл settings.json , используя команду Open Settings (JSON) или изменив редактор настроек по умолчанию с помощью workbench.settings.editor установка.

В зависимости от вашей платформы файл пользовательских настроек находится здесь:

• Windows % APPDATA% \ Code \ User \ settings.json
• macOS $ ГЛАВНАЯ / Библиотека / Поддержка приложений / Код / Пользователь / Настройки.JSON
• Linux $ ГЛАВНАЯ / .config / Код / Пользователь / settings.json

Файл настроек рабочей области находится в папке .vscode в корневой папке.

Примечание: В случае многокорневой рабочей области настройки рабочей области находятся в файле конфигурации рабочей области.

Настройки редактора для конкретного языка

Чтобы настроить редактор в соответствии с языком, выполните глобальную команду «Предпочтения: настройка параметров для конкретного языка » (идентификатор команды: верстак.action.configureLanguageBasedSettings ) из палитры команд (⇧⌘P (Windows, Linux Ctrl + Shift + P)), которая открывает средство выбора языка. Выбрав нужный язык, откроется редактор настроек с вводом языка, где вы можете добавить соответствующие настройки.

Если у вас открыт файл и вы хотите настроить редактор для этого типа файлов, щелкните «Языковой режим» в строке состояния в правом нижнем углу окна VS Code.Откроется средство выбора языкового режима с опцией . Конфигурирование языковых настроек «language_name» . При выборе этого откроется редактор настроек с вводом языка, в который вы можете добавить соответствующие настройки.

Вы также можете настроить языковые настройки, открыв settings.json . Вы можете поместить их в рабочее пространство, поместив их в параметры рабочего пространства, как и другие параметры. Если у вас есть настройки, определенные для языка как в пользовательской, так и в рабочей области, то они объединяются, отдавая приоритет тем, которые определены в рабочей области.

В следующих примерах настраиваются параметры редактора для языковых режимов , машинопись и разметки .

  {
  "[машинопись]": {
    "editor.formatOnSave": правда,
    "editor.formatOnPaste": правда
  },
  "[уценка]": {
    "editor.formatOnSave": правда,
    "editor.wordWrap": "on",
    "editor.renderWhitespace": "все",
    "editor.acceptSuggestionOnEnter": "off"
  }
}  

Вы можете использовать IntelliSense в редакторе настроек, чтобы найти допустимые языковые настройки.Все настройки редактора и некоторые нередакторные настройки поддерживаются.

Настройки и безопасность

Некоторые параметры позволяют указать исполняемый файл, который VS Code будет запускать для выполнения определенных операций. Например, вы можете выбрать, какую оболочку использовать интегрированный терминал. Для повышения безопасности такие параметры могут быть определены только в пользовательских настройках, а не в области рабочей области.

Вот список настроек, которые не поддерживаются в настройках рабочей области:

• путь
• терминал.внешний.окнаExec
• терминал. Внешний.osxExec
• терминал.external.linuxExec

При первом открытии рабочей области, в которой определены какие-либо из этих параметров, VS Code предупредит вас и впоследствии всегда будет игнорировать значения после этого.

Настройки по умолчанию

Ниже приведены стандартные настройки кода Visual Studio и их значения. Вы также можете просмотреть значения по умолчанию в редакторе настроек.

  {
  // Редактор

  // Когда он включен, редактор diff игнорирует изменения в начальных или конечных пробелах.
  "diffEditor.ignoreTrimWhitespace": правда,

  // Тайм-аут в миллисекундах, после которого вычисление различий отменяется. Используйте 0 для отсутствия тайм-аута.
  "diffEditor.maxComputationTime": 5000,

  // Управляет показом редактора diff +/- индикаторов для добавленных / удаленных изменений.
  "diffEditor.renderIndicators": правда,

  // Контролирует, будет ли редактор diff отображать diff бок о бок или в строке."diffEditor.renderSideBySide": правда,

  // Определяет, следует ли принимать предложения по символам фиксации. Например, в JavaScript точка с запятой (`;`) может быть символом фиксации, который принимает предложение и вводит этот символ.
  "editor.acceptSuggestionOnCommitCharacter": правда,

  // Контролирует, должны ли предложения приниматься на `Enter`, в дополнение к` Tab`. Помогает избежать двусмысленности между вставкой новых строк или принятием предложений.
  // - вкл
  // - smart: принимать предложение только с `Enter`, когда оно вносит текстовые изменения.// - выкл
  "editor.acceptSuggestionOnEnter": "on",

  // Управляет количеством строк в редакторе, которые могут быть прочитаны программой чтения с экрана. Предупреждение: это влияет на производительность для чисел, превышающих значения по умолчанию.
  "editor.accessibilityPageSize": 10,

  // Управляет тем, должен ли редактор работать в режиме, в котором он оптимизирован для программ чтения с экрана.
  // - auto: редактор будет использовать API-интерфейсы платформы, чтобы определять, когда подключен Screen Reader.
  // - on: редактор будет постоянно оптимизирован для использования с Screen Reader.// - off: редактор никогда не будет оптимизирован для использования с Screen Reader.
  "editor.accessibilitySupport": "auto",

  // Управляет тем, должен ли редактор автоматически закрывать скобки после того, как пользователь добавляет открывающую скобку.
  // - всегда
  // - languageDefined: использовать языковые конфигурации, чтобы определить, когда следует автоматически заключать скобки.
  // - beforeWhitespace: автоматическое закрытие скобок, только когда курсор находится слева от пробела.
  //  - никогда
  "редактор.autoClosingBrackets ":" languageDefined ",

  // Управляет, должен ли редактор печатать закрывающие кавычки или скобки.
  // - всегда
  // - auto: вводить закрывающие кавычки или скобки, только если они были вставлены автоматически.
  //  - никогда
  "editor.autoClosingOverype": "авто"

  // Управляет тем, должен ли редактор автоматически закрывать кавычки после того, как пользователь добавляет начальную кавычку.
  // - всегда
  // - languageDefined: Используйте языковые конфигурации, чтобы определить, когда нужно автоматически заключать кавычки.// - beforeWhitespace: автоматическое закрытие кавычек, только когда курсор находится слева от пробела.
  //  - никогда
  "editor.autoClosingQuotes": "languageDefined",

  // Управляет тем, должен ли редактор автоматически корректировать отступ при вводе, вставке, перемещении или отступе строк.
  // - none: редактор не вставит отступ автоматически.
  // - keep: редактор будет сохранять отступ текущей строки.
  // - скобки: редактор сохранит отступ текущей строки и соберет скобки, определенные для языка.// - продвинутый: редактор будет хранить отступ текущей строки, учитывать скобки, определенные для языка, и вызывать специальные onEnterRules, определенные языками.
  // - full: редактор будет хранить отступ текущей строки, учитывать скобки, определенные для языка, вызывать специальные onEnterRules, определенные языками, и уважать indentationRules, определенные языками.
  "editor.autoIndent": "full",

  // Управляет, должен ли редактор автоматически окружать выборки.
  // - languageDefined: Используйте языковые конфигурации, чтобы определить, когда автоматически окружать выборки.// - кавычки: Окружать кавычками, но не скобками.
  // - скобки: окружать скобками, но не кавычками.
  //  - никогда
  "editor.autoSurround": "languageDefined",

  // Виды действий кода для запуска при сохранении.
  "editor.codeActionsOnSave": {},

  // Управляет показом редактора CodeLens.
  "editor.codeLens": правда,

  // Управляет, должен ли редактор отображать встроенные цветовые декораторы и палитру цветов.
  "editor.colorDecorators": правда,

  // Включаем, что выделение с помощью мыши и клавиш делает выбор столбца."editor.columnSelection": ложь,

  // Управляет вставкой пробела при комментировании.
  "editor.comments.insertSpace": правда,

  // Управляет тем, должна ли подсветка синтаксиса копироваться в буфер обмена.
  "editor.copyWithSyntaxHighlighting": правда,

  // Управляем стилем анимации курсора.
  "editor.cursorBlinking": "мигать",

  // Управляет включением анимации сглаживания.
  "editor.cursorSmoothCaretAnimation": ложь,

  // Управляет стилем курсора."editor.cursorStyle": "линия",

  // Управляет минимальным количеством видимых ведущих и конечных линий, окружающих курсор. Известный как scrollOff или scrollOffset в некоторых других редакторах.
  "editor.cursorSurroundingLines": 0,

  // Управляет тем, когда `cursorSurroundingLines` должен выполняться.
  // - по умолчанию: 'cursorSurroundingLines` применяется только при запуске с клавиатуры или API.
  // - all: `cursorSurroundingLines` применяется всегда.
  "редактор.cursorSurroundingLinesStyle ":" default ",

  // Управляет шириной курсора, когда для `editor.cursorStyle` установлено значение` line`.
  "editor.cursorWidth": 0,

  // Определяет форматтер по умолчанию, который имеет приоритет над всеми другими настройками форматера. Должен быть идентификатором расширения, предоставляющего форматер.
  "editor.defaultFormatter": ноль,

  // Контролирует, всегда ли жест мыши Перейти к определению открывает виджет.
  "editor.definitionLinkOpensInPeek": false,

  // Управляет ли `редактор.tabSize # `и` # editor.insertSpaces` будут автоматически обнаружены при открытии файла на основе содержимого файла.
  "editor.detectIndentation": правда,

  // Контролирует, должен ли редактор разрешать перемещение выделений с помощью перетаскивания.
  "editor.dragAndDrop": правда,

  // Управляет копированием текущей строки без выделения.
  "editor.emptySelectionClipboard": правда,

  // Множитель скорости прокрутки при нажатии клавиши `Alt`.
  "editor.fastScrollSensitivity": 5,

  // Управляет тем, должен ли виджет поиска добавлять дополнительные строки поверх редактора.Если это правда, вы можете прокрутить за первую строку, когда виджет поиска виден.
  "editor.find.addExtraSpaceOnTop": правда,

  // Управляет выполнением операции поиска для выделенного текста или всего файла в редакторе.
  // - никогда: Никогда не включать Поиск в выделении автоматически (по умолчанию)
  // - всегда: всегда включать Поиск в выделении автоматически
  // - многострочный: включение функции «Найти в выделении» автоматически при выделении нескольких строк контента.
  "редактор.find.autoFindInSelection ":" never ",

  // Управляет тем, должен ли виджет поиска читать или изменять общий буфер поиска в macOS.
  "editor.find.globalFindClipboard": false,

  // Управляет тем, будет ли поиск автоматически перезапущен с начала (или конца), когда дальнейшие совпадения не найдены.
  "editor.find.loop": правда,

  // Контролирует, будет ли строка поиска в виджете поиска видна из выбора редактора.
  "editor.find.seedSearchStringFromSelection": true,

  // Управляет включением в редакторе свертывания кода."editor.folding": правда,

  // Управляет, должен ли редактор выделять свернутые диапазоны.
  "editor.foldingHighlight": правда,

  // Управляет стратегией вычисления диапазонов фолдинга.
  // - auto: использовать стратегию свертывания для конкретного языка, если она доступна, в противном случае - на основе отступа.
  // - отступ: использовать стратегию свертывания на основе отступа.
  "editor.foldingStrategy": "auto",

  // Управляет семейством шрифтов.
  "editor.fontFamily": "Consolas, 'Courier New', monospace",

  // Конфигурирует лигатуры шрифта или функции шрифта."editor.fontLigatures": ложь,

  // Управляет размером шрифта в пикселях.
  "editor.fontSize": 14,

  // Управляет весом шрифта.
  "editor.fontWeight": "нормальный",

  // Управляет, должен ли редактор автоматически форматировать вставленный контент. Форматер должен быть доступен, и он должен иметь возможность форматировать диапазон в документе.
  "editor.formatOnPaste": ложь,

  // Форматировать файл при сохранении. Форматер должен быть доступен, файл не должен быть сохранен после задержки, и редактор не должен закрываться."editor.formatOnSave": ложь,

  // Управляет тем, должен ли редактор автоматически форматировать строку после ввода.
  "editor.formatOnType": ложь,

  // Управляет, должен ли редактор отображать вертикальное поле глифа. Поле Glyph в основном используется для отладки.
  "editor.glyphMargin": правда,

  // Альтернативный идентификатор команды, которая выполняется, когда результатом «Перейти к объявлению» является текущее местоположение.
  "editor.gotoLocation.alternativeDeclarationCommand": "редактор.action.goToReferences»,

  // Альтернативный идентификатор команды, которая выполняется, когда результатом «Перейти к определению» является текущее местоположение.
  "editor.gotoLocation.alternativeDefinitionCommand": "editor.action.goToReferences",

  // Альтернативный идентификатор команды, которая выполняется, когда результатом «Перейти к реализации» является текущее местоположение.
  "editor.gotoLocation.alternativeImplementationCommand": "",

  // Альтернативный идентификатор команды, которая выполняется, когда результатом 'Go to Reference' является текущее местоположение."editor.gotoLocation.alternativeReferenceCommand": "",

  // Альтернативный идентификатор команды, которая выполняется, когда результатом «Перейти к определению типа» является текущее местоположение.
  "editor.gotoLocation.alternativeTypeDefinitionCommand": "editor.action.goToReferences",

  // Управляет поведением команды «Перейти к объявлению», когда существует несколько целевых местоположений.
  // - peek: Показать обзор результатов (по умолчанию)
  // - gotoAndPeek: перейти к основному результату и показать обзор
  // - goto: перейти к первичному результату и включить бесхитростную навигацию для других
  "редактор.gotoLocation.multipleDeclarations ":" peek ",

  // Управляет поведением команды «Перейти к определению», когда существует несколько целевых местоположений.
  // - peek: Показать обзор результатов (по умолчанию)
  // - gotoAndPeek: перейти к основному результату и показать обзор
  // - goto: перейти к первичному результату и включить бесхитростную навигацию для других
  "editor.gotoLocation.multipleDefinitions": "peek",

  // Управляет поведением команды «Перейти к реализации», когда существует несколько целевых местоположений.// - peek: Показать обзор результатов (по умолчанию)
  // - gotoAndPeek: перейти к основному результату и показать обзор
  // - goto: перейти к первичному результату и включить бесхитростную навигацию для других
  "editor.gotoLocation.multipleImplementations": "peek",

  // Управляет поведением команды «Перейти к ссылкам», когда существует несколько целевых местоположений.
  // - peek: Показать обзор результатов (по умолчанию)
  // - gotoAndPeek: перейти к основному результату и показать обзор
  // - goto: перейти к первичному результату и включить бесхитростную навигацию для других
  "редактор.gotoLocation.multipleReferences ":" peek ",

  // Управляет поведением команды «Перейти к определению типа», когда существует несколько целевых местоположений.
  // - peek: Показать обзор результатов (по умолчанию)
  // - gotoAndPeek: перейти к основному результату и показать обзор
  // - goto: перейти к первичному результату и включить бесхитростную навигацию для других
  "editor.gotoLocation.multipleTypeDefinitions": "peek",

  // Управляет тем, должен ли курсор быть скрыт в обзорной линейке."editor.hideCursorInOverviewRuler": false,

  // Управляет, должен ли редактор выделять активное руководство по отступам.
  "editor.highlightActiveIndentGuide": правда,

  // Управляет задержкой в ​​миллисекундах, после которой отображается зависание.
  "editor.hover.delay": 300,

  // Управляет показом парения.
  "editor.hover.enabled": правда,

  // Управляет тем, должен ли указатель мыши оставаться видимым при наведении на него мыши.
  "редактор.hover.sticky ": правда,

  // Вставка пробелов при нажатии клавиши `Tab`. Этот параметр переопределяется в зависимости от содержимого файла, когда `editor.detectIndentation` включен.
  "editor.insertSpaces": правда,

  // Управляет межбуквенным интервалом в пикселях.
  "editor.letterSpacing": 0,

  // Включает лампочку действия кода в редакторе.
  "editor.lightbulb.enabled": правда,

  // Управляет высотой строки. Используйте 0, чтобы вычислить высоту строки из размера шрифта.
  "редактор.lineHeight ": 0,

  // Управляет отображением номеров строк.
  // - off: номера строк не отображаются.
  // - on: номера строк отображаются как абсолютные числа.
  // - относительный: номера строк отображаются как расстояние в строках до позиции курсора.
  // - интервал: номера строк отображаются каждые 10 строк.
  "editor.lineNumbers": "on",

  // Управляет, должен ли редактор обнаруживать ссылки и делать их кликабельными.
  "editor.links": правда,

  // Выделить соответствующие скобки."editor.matchBrackets": "всегда",

  // Управляет показом миникарты.
  "editor.minimap.enabled": правда,

  // Ограничение ширины миникарты для отображения не более определенного числа столбцов.
  "editor.minimap.maxColumn": 120,

  // Рендеринг реальных символов в строке, а не цветовых блоков.
  "editor.minimap.renderCharacters": правда,

  // Масштаб содержимого, нарисованного в миникарте: 1, 2 или 3.
  "editor.minimap.scale": 1,

  // Управляет показом слайдера миникарты."editor.minimap.showSlider": "наведение мыши",

  // Управляет стороной рендеринга миникарты.
  "editor.minimap.side": "правильно",

  // Управляет размером миникарты.
  // - пропорционально: миникарта имеет тот же размер, что и содержимое редактора (и может прокручиваться).
  // - fill: миникарта будет растягиваться или уменьшаться по мере необходимости, чтобы заполнить высоту редактора (без прокрутки).
  // - fit: миникарта будет сжиматься по мере необходимости, чтобы никогда не быть больше редактора (без прокрутки)."editor.minimap.size": "пропорциональный",

  // Множитель, который будет использоваться для `deltaX` и` deltaY` событий прокрутки колеса мыши.
  "editor.mouseWheelScrollSensitivity": 1,

  // Масштаб шрифта редактора при использовании колесика мыши и удержании клавиши `Ctrl`.
  "editor.mouseWheelZoom": ложь,

  // Модификатор, который будет использоваться для добавления нескольких курсоров с помощью мыши. Жесты мыши «Перейти к определению» и «Открыть ссылку» будут адаптироваться таким образом, чтобы они не конфликтовали с модификатором мультивекторов.[Читать дальше] (https://code.visualstudio.com/docs/editor/codebasics#_multicursor-modifier).
  // - ctrlCmd: сопоставляет «Control» в Windows и Linux и «Command» в macOS.
  // - alt: сопоставляет «Alt» в Windows и Linux и «Option» в macOS.
  "editor.multiCursorModifier": "alt",

  // Управляет вставкой, когда количество строк вставленного текста совпадает с количеством курсоров.
  // - распространение: каждый курсор вставляет одну строку текста.
  // - полный: каждый курсор вставляет полный текст."editor.multiCursorPaste": "распространение",

  // Управляет, должен ли редактор выделять вхождения семантического символа.
  "editor.occurferencesHighlight": правда,

  // Управляет ли граница с  

— Веб-технология для разработчиков

элементов типа search — это текстовые поля, предназначенные для ввода пользователем поисковых запросов. Они функционально идентичны текстовым вводам , но могут по-разному оформляться пользовательским агентом.

Значение

Атрибут value содержит DOMString , представляющую значение, содержащееся в поле поиска. Вы можете получить это, используя свойство HTMLInputElement.value в JavaScript.

 searchTerms = mySearch.value;
 

Если для входных данных нет ограничений проверки (см. Подробности в разделе Проверка), значением может быть любая текстовая строка или пустая строка ( "" ).

Дополнительные атрибуты

В дополнение к атрибутам, которые работают со всеми элементами независимо от их типа, входные данные поля поиска поддерживают следующие атрибуты:

список

Значения атрибута списка — это идентификатор элемента , расположенного в том же документе. предоставляет список предопределенных значений, чтобы предложить пользователю для этого ввода. Любые значения в списке, которые не совместимы с , тип , не включены в предлагаемые параметры. Предоставленные значения являются предложениями, а не требованиями: пользователи могут выбирать из этого предварительно определенного списка или предоставлять другое значение.

maxlength

Максимальное количество символов (в единицах кода UTF-16), которое пользователь может ввести в поле поиска.Это должно быть целочисленное значение 0 или выше. Если не указана максимальная длина или указано недопустимое значение, поле поиска не имеет максимальной длины. Это значение также должно быть больше или равно значению minlength .

Входные данные не пройдут проверку ограничения, если длина текста, введенного в поле, превышает maxlength, кодовых единиц UTF-16.

minlength

Минимальное количество символов (в единицах кода UTF-16), которое пользователь может ввести в поле поиска.Это должно быть неотрицательное целочисленное значение, меньшее или равное значению, указанному maxlength . Если не указана minlength или указано недопустимое значение, входной поиск не имеет минимальной длины.

Поле поиска не пройдёт проверку ограничения, если длина введенного в поле текста меньше минут длины кодовых единиц UTF-16.

шаблон

Атрибут шаблона , если он указан, является регулярным выражением, которому значение входа должно соответствовать , чтобы значение прошло проверку ограничения.Это должно быть допустимое регулярное выражение JavaScript, используемое типом RegExp и задокументированное в нашем руководстве по регулярным выражениям; флаг 'u' задается при компиляции регулярного выражения, чтобы шаблон обрабатывался как последовательность кодовых точек Unicode, а не как ASCII. Вокруг текста шаблона нельзя указывать косую черту.

Если указанный шаблон не указан или является недопустимым, регулярное выражение не применяется и этот атрибут полностью игнорируется.

Совет: Используйте атрибут title , чтобы указать текст, который большинство браузеров будет отображать в виде всплывающей подсказки, объясняющей, какие требования соответствуют шаблону. Вы должны также включить другой пояснительный текст поблизости.

См. Раздел «Задание шаблона» для получения подробной информации и примера.

заполнитель

Атрибут-заполнитель — это строка, которая дает пользователю краткую подсказку о том, какая информация ожидается в поле.Это должно быть слово или короткая фраза, которая демонстрирует ожидаемый тип данных, а не пояснительное сообщение. Текст не должен включать в себя возврат каретки или перевод строки.

Если содержимое элемента управления имеет одну направленность (LTR или RTL), но необходимо представить заполнитель в противоположной направленности, можно использовать символы форматирования двунаправленного алгоритма Unicode для переопределения направленности в заполнителе; см. Переопределение BiDi с использованием управляющих символов Unicode в Двунаправленном текстовом алгоритме Unicode для этих символов.

только для чтения

Логический атрибут, который, если присутствует, означает, что это поле не может быть отредактировано пользователем. Его значение , однако, все еще может быть изменено с помощью кода JavaScript, напрямую устанавливающего свойство HTMLInputElement.value .

Примечание: Поскольку поле только для чтения не может иметь значение, необходимое значение не влияет на входы с указанным атрибутом только для чтения .

размер

Атрибут size — это числовое значение, указывающее, сколько символов должно быть в ширине поля ввода.Значение должно быть числом больше нуля, а значение по умолчанию равно 20. Поскольку ширина символов различается, это может быть или не быть точным, и на него нельзя полагаться; результирующий ввод может быть уже или шире, чем указанное количество символов, в зависимости от символов и шрифта (используются настройки font ).

Это делает , а не , устанавливает ограничение на количество символов, которое пользователь может ввести в поле. Это только указывает приблизительно, сколько можно увидеть за один раз.Чтобы установить верхний предел длины входных данных, используйте атрибут maxlength .

проверка орфографии

Нестандартные атрибуты

Следующие нестандартные атрибуты доступны для полей ввода поиска. Как правило, вы должны избегать их использования, если это не помогло.

автозамена

Расширение Safari, автозамена , атрибут — это строка, которая указывает, активировать или нет автоматическое исправление, когда пользователь редактирует это поле.Допустимые значения:

по

Включить автоматическое исправление опечаток, а также обработку подстановок текста, если таковые настроены.

от

Отключить автоматическое исправление и подстановку текста.

добавочный

Логический атрибут incremental является расширением WebKit и Blink (поддерживается Safari, Opera, Chrome и т. Д.).) который, если присутствует, указывает агенту пользователя обрабатывать ввод как живой поиск. Когда пользователь редактирует значение поля, пользовательский агент отправляет событий поиска в объект HTMLInputElement , представляющий поле поиска. Это позволяет вашему коду обновлять результаты поиска в режиме реального времени, когда пользователь редактирует результаты поиска.

Если , инкремент не указан, событие поиска отправляется только тогда, когда пользователь явно инициирует поиск (например, нажатием клавиши , ввода или , возврата при редактировании поля).

Событие поиска ограничено по скорости, поэтому оно не отправляется чаще, чем интервал, определенный реализацией.

mozactionhint

Расширение Mozilla, поддерживаемое Firefox для Android, которое дает подсказку о том, какие действия будут предприняты, если пользователь нажимает клавиши Enter или Return при редактировании поля. Эта информация используется для определения того, какую метку использовать на клавиатуре Ввод на виртуальной клавиатуре.

Допустимые значения: - , - , - , - поиск и - отправка . С помощью этой подсказки браузер решает, какую метку поставить на клавишу ввода.

результаты

Атрибут результатов , поддерживаемый только Safari, представляет собой числовое значение, которое позволяет переопределить максимальное количество записей, отображаемых в исходном раскрывающемся меню элемента предыдущих поисковых запросов.

Значение должно быть неотрицательным десятичным числом. Если не указано или указано недопустимое значение, используется максимальное количество записей в браузере по умолчанию.

Использование поисковых входов

элементов типа search очень похожи на элементы типа text , за исключением того, что они специально предназначены для обработки поисковых терминов. Они в основном эквивалентны по поведению, но пользовательские агенты могут по умолчанию выбирать их стили (и, конечно, сайты могут использовать таблицы стилей для применения к ним пользовательских стилей).

Базовый пример

 <форма>
  

    
    Кнопка <> Поиск 
  
 

Это выглядит так:

q - наиболее распространенное имя , данное для входных данных поиска, хотя это не обязательно. После отправки пара данных имя / значение, отправляемая на сервер, будет q = searchterm .

Вы должны не забыть установить имя для вашего ввода, иначе ничего не будет отправлено.

Различия между типами поиска и текста

Основные отличия заключаются в том, как браузеры обрабатывают их. Первое, на что следует обратить внимание, это то, что в некоторых браузерах отображается крестик, по которому можно щелкнуть, чтобы при желании мгновенно удалить поисковый запрос Следующий скриншот взят из Chrome:

Кроме того, современные браузеры также склонны автоматически сохранять поисковые термины, ранее введенные в домены, которые затем становятся опциями автозаполнения, когда последующие поиски выполняются во входных данных поиска в этом домене.Это помогает пользователям, которые стремятся выполнять поиск по одним и тем же поисковым запросам с течением времени. Этот скриншот с Firefox:

На этом этапе давайте рассмотрим некоторые полезные методы, которые вы можете применить к своим формам поиска.

Настройка заполнителей

Вы можете предоставить полезный заполнитель внутри своего поискового ввода, который мог бы дать подсказку о том, что делать, используя атрибут заполнителя . Посмотрите на следующий пример:

 <форма>
  

    
    Кнопка <> Поиск 
  
 

Вы можете увидеть, как заполнитель отображается ниже:

Форма поиска ярлыков и доступность

Одна проблема с формами поиска - их доступность; обычной практикой проектирования не является предоставление метки для поля поиска (хотя там может быть значок увеличительного стекла или аналогичный), поскольку назначение формы поиска обычно довольно очевидно для зрячих пользователей из-за размещения (в этом примере показана типичная шаблон).

Это, однако, может вызвать путаницу у пользователей программ чтения с экрана, поскольку они не будут иметь никакого устного указания о том, что представляет собой поисковый ввод. Одним из способов избежать этого, который не повлияет на ваш визуальный дизайн, является использование функций WAI-ARIA:

• Атрибут роли со значением поиска в элементе
  заставит экранные программы объявить, что форма является формой поиска.
• Если этого недостаточно, вы можете использовать атрибут aria-label для самого .Это должна быть описательная текстовая метка, которая будет считываться программой чтения с экрана; используется как невизуальный эквивалент .

Давайте посмотрим на пример:

 
  

    
    Кнопка <> Поиск 
  
 

Вы можете увидеть, как это отображается ниже:

Нет визуального отличия от предыдущего примера, но пользователи программы чтения с экрана имеют гораздо больше информации, доступной для них.

Физический размер элемента ввода

Физический размер поля ввода можно контролировать с помощью атрибута размера . С его помощью вы можете указать количество символов, которое поле ввода может отображать одновременно. Например, в этом примере поле поиска имеет ширину 30 символов:

 <форма>
  

    
    Кнопка <> Поиск 
  
 

Результатом является более широкое поле ввода:

Валидация

элементов типа search имеют те же функции проверки, что и обычные текстовые входы .Менее вероятно, что вы захотите использовать функции проверки в целом для полей поиска. Во многих случаях пользователям должно быть разрешено искать что-либо, но есть несколько случаев, которые следует учитывать, например, поиск по данным известного формата.

Примечание : проверка формы HTML - , а не - замена сценариев, обеспечивающих правильность введенных данных. Для кого-то слишком легко вносить изменения в HTML, которые позволяют ему обойти проверку или полностью ее удалить.Кроме того, кто-то может просто полностью обойти ваш HTML и отправить данные непосредственно на ваш сервер. Если ваш код на стороне сервера не может проверить полученные данные, может произойти авария, если в вашу базу данных будут введены неправильно отформатированные данные (или данные слишком большого размера, неправильного типа и т. Д.).

Замечание по стайлингу

Существуют полезные псевдоклассы, доступные для стилизации допустимых / недействительных элементов формы: : действительные и : недействительные .В этом разделе мы будем использовать следующий CSS, который будет ставить галочку (галочку) рядом с входными данными, содержащими допустимые значения, и крестиком рядом с входными данными, содержащими недопустимые значения.

: неверно ~ span: after {
    содержание: «✖»;
    отступ слева: 5 пикселей;
    положение: абсолютное;
}

вход: действительный ~ span: после {
    содержание: «✓»;
    отступ слева: 5 пикселей;
    положение: абсолютное;
} 

Метод также требует, чтобы элемент был помещен после элемента формы, который выступает в качестве держателя для значков.Это было необходимо, потому что некоторые типы ввода в некоторых браузерах не очень хорошо отображают значки, расположенные сразу после них.

Требуется ввод

Атрибут требуемый можно использовать как простой способ ввода значения, необходимого для отправки формы:

 <форма>
  

    
    Кнопка <> Поиск 
     
  
 

 вход {
  поле справа: 10 пикселей;
}

ввод: неверный ~ span: после {
    содержание: «✖»;
    отступ слева: 5 пикселей;
    положение: абсолютное;
}

вход: действительный ~ span: после {
    содержание: «✓»;
    отступ слева: 5 пикселей;
    положение: абсолютное;
} 

Это выглядит так:

Кроме того, если вы попытаетесь отправить форму без введенного поискового запроса, браузер отобразит сообщение.Следующий пример из Firefox:

Различные сообщения будут отображаться при попытке отправить форму с различными типами недействительных данных, содержащихся во входах; см. примеры ниже.

Длина входного значения

Вы можете указать минимальную длину в символах для введенного значения с помощью атрибута minlength ; аналогично, используйте maxlength , чтобы установить максимальную длину введенного значения.

В приведенном ниже примере требуется, чтобы введенное значение было длиной 4–8 символов.

 <форма>
  

     Поиск пользователя 
    
    Кнопка <> Поиск 
     
  
 

 вход {
  поле справа: 10 пикселей;
}

ввод: неверный ~ span: после {
    содержание: «✖»;
    отступ слева: 5 пикселей;
    положение: абсолютное;
}

вход: действительный ~ span: после {
    содержание: «✓»;
    отступ слева: 5 пикселей;
    положение: абсолютное;
} 

Это выглядит так:

Если вы попытаетесь отправить форму длиной менее 4 символов, вам будет выдано соответствующее сообщение об ошибке (которое отличается в разных браузерах).Если вы попытаетесь выйти за пределы 8 символов, браузер не позволит вам.

Указание шаблона

Атрибут шаблона можно использовать для указания регулярного выражения, которому должно следовать введенное значение, чтобы оно считалось действительным (см. Проверка правильности регулярного выражения для простого ускоренного курса).

Давайте посмотрим на пример. Скажем, мы хотели предоставить форму поиска идентификатора продукта, и все идентификаторы были кодами из двух букв, за которыми следовали четыре цифры. Следующий пример покрывает это:

 <форма>
  

     Поиск товара по идентификатору: 
    
    Кнопка <> Поиск 
     
  
 

 вход {
  поле справа: 10 пикселей;
}

ввод: неверный ~ span: после {
    содержание: «✖»;
    отступ слева: 5 пикселей;
    положение: абсолютное;
}

вход: действительный ~ span: после {
    содержание: «✓»;
    отступ слева: 5 пикселей;
    положение: абсолютное;
} 

Это выглядит так:

Примеры

Вы можете увидеть хороший пример поисковой формы, используемой в контексте, на нашем примере website-aria-role (посмотреть его вживую).

Технические характеристики

Совместимость браузера