Разработка технической документации и технические писатели Технические писатели и разработка технической документации технические писатели в Телеграм 

 obmen_soobsheniyami.png Чат для технических писателей 
 Зарегистрируйтесь
Страницы: 1
RSS
помогите оформить описание к HTML разметке, как оформить описание к HTML разметке
 
Здравствуйте. Помогите пожалуйста правильно оформить кусок руководства по разработке приложения. Это ТЗ для вакансии технического писателя, хочется сделать хорошо.
1. Есть небольшой кусок HTML-разметки, включающий 2 элемента. Разметка для элементов практически одинаковая, только Id у них разные и data-source. Вопрос состоит в том, как лучше описать - для каждого элемента расписывать разметку, что приведет к дублированию части текста, или написать "в общем". Но тогда не будет указано что данным элементам присвоены такие-то id. В последующих шагах руководства я буду ссылаться на эти элементы с этими Id. Прикладываю HTML, и далее свой вариант текста, в котором сомневаюсь.
2. Как правильно ссылаться на HTML элемент c ID? Указывать ли только ID или указывать вместе с тем тег?
Буду очень благодарна за помощь.
Код
<div id="comboText">
    <p>Text:</p>
    <div class="comboboxContainer">
        @Html.DropDownList("Texts", new SelectList(ViewBag.Texts), "Sel ect text", new { @class = "form-control" })
    </div>
</div>

<div id="comboTime">
    <p>Time, min.:</p>
    <div class="comboboxContainer">
        @Html.DropDownList("Time", new SelectList(ViewBag.timeList), "Select time, min.", new { @class = "form-control" })
    </div>
</div>
Код
<p>The tag helpers <code>Html.DropDownList</code> are used to generate HTML <i>select</i> elements which are drop-down combo boxes. The piece of HTML markup for each combo box contains <b><div></b> block as wrapper for the combo box 
and the <b><p></b> element with text as a title for the combo box. It also includes <b><div></b> wrapper to group the elements of each combo box.</p>
<p>The <a href="https://msdn.microsoft.com/en-us/library/system.web.mvc.html.selectextensions.dropdownlist(v=vs.118).aspx">overload</a> of the <code>Html.DropDownList</code> method which is used in the code above accepts the 
following parameters:</p>
            <ul>
                <li><p>String name - the name of the form field to return.</p></li>
                <li><p>IEnumerable<SelectlistItem> selectList - a collection of SelectListItem objects that are used to populate the drop-down list.</p></li>
                <li><p>String optionLabel - the text for a default empty item. This parameter can be null.</p></li>
                <li><p>Object htmlAttributes - an object that contains the HTML attributes to set for the element.</p></li>
            </ul>
<p>In accordance with the overload, you send four parameters for every drop-down list. The third parameter is a new <i>select</i> HTML element, that includes <code>ViewBag.Texts</code> property for the drop-down combo box with 
texts values is used as a source for the drop-down list. It includes the "ViewBag.Texts" property which was sent to this View fr om the "Index" Controller Method.</p>
Страницы: 1
Читают тему